package com.vdong.supplier.service.supplierbird;

import com.vdong.supplier.request.supplierbird.EbusinessOrderHandleRequest;
import com.vdong.supplier.response.supplierbird.KdnResponse;

/**
 * @author 快递鸟基础接口服务
 */
public interface PostQueryClassService {

    /**
     * * （1）查询接口支持按照运单号查询(单个查询)。 （2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
     * 如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码 （3）返回的物流跟踪信息按照发生的时间升序排列。 （4）接口指令1002。
     * （5）接口支持的消息接收方式为HTTP
     * POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
     * （6）接口地址： API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx
     *
     * @param ebusinessOrderHandleRequest
     * @return EbusinessOrderHandleResponse 返回封装 or null（exception timeout）
     */
    KdnResponse EbusinessOrderHandle(EbusinessOrderHandleRequest ebusinessOrderHandleRequest);

    /**
     * 电子面单
     *
     * @param ebusinessOrderHandleRequest
     * @param environment 环境切换 0测试，1正式
     * @return EbusinessOrderHandleResponse 返回封装 or null（exception timeout）
     */
    KdnResponse EbusinessOrder(EbusinessOrderHandleRequest ebusinessOrderHandleRequest, int environment);

    /**
     * 预约取件
     *
     * @param ebusinessOrderHandleRequest
     * @param environment 环境切换 0测试，1正式
     * @return EbusinessOrderHandleResponse 返回封装 or null（exception timeout）
     */
    KdnResponse EbusinessOOrder(EbusinessOrderHandleRequest ebusinessOrderHandleRequest, int environment);

    /**
     * 取消订单
     * @param ebusinessOrderHandleRequest
     * @param environment 环境切换 0测试，1正式
     * @return
     */
    KdnResponse EbusinessCancleOrder(EbusinessOrderHandleRequest ebusinessOrderHandleRequest, int environment);

}
